home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 026-050 / scopedisk27 / duh27 / du-hermes.doc < prev    next >
Text File  |  1995-03-18  |  17KB  |  358 lines

  1.  
  2.  
  3.                        HERMES' DU-HERMES  (Version 2.7)
  4.  
  5.                      Copyright (c) 1987-88 A. G. Kartsatos 
  6.  
  7.               (CIS = 76617,121, GEnie = XTH58515, PLink = HERMES)
  8.  
  9.  
  10.                         ***  Shareware Program  ***
  11.  
  12.  
  13.        This version has a Touch of Class!  At least I think so!
  14.  
  15.        I have added 3 more items in a second menu: SAVE LIST, PATTERN MATCH,
  16. and LOCATE FILE.  You can find the description of their functions below.
  17.        I have also made it much easier to change the colors and the
  18. HERMES.file path than before.
  19.        This is now a major all purpose Directory Utility.  Master it and
  20. you'll see how efficient it is.
  21.  
  22. *      TO RUN IT IMMEDIATELY: Make sure you have STACK, ARC, SHOW and EDIT  *
  23. * in your current c directory.  EDIT is the name of your Editor program.    *
  24. *      Place the file MODULE in the same c directory.                       *
  25. *      Press: RUN DU-HERMES, or CLICK THE DU-HERMES icon from the WBench.   *
  26. *      TO EXIT THE PROGRAM: Choose QUIT from the menu, or click into the    *
  27. * rectangle at the bottom right of the screen, or press RIGHT_AMIGA-Q.      *
  28. *                                                                           *
  29.  
  30.  
  31. *                      $$$    ATTENTION    $$$                              *
  32. *                                                                           *
  33. *      Read below about changing the COLORS of DU-HERMES, or its DRIVE      *
  34. * NAMES, or the PATH of the HERMES.file.  It is all VERY SIMPLE!!!          *
  35.  
  36.  
  37.        A) CHANGE DRIVES:
  38.  
  39.           Just replace the seven drive names on the first line of 
  40.           HERMES.file by the drive names of your choice.  DU-HERMES will
  41.           show first the first drive in that list.  Leave one space between
  42.           the drive names.
  43.  
  44.        B) CHANGE COLORS:
  45.  
  46.           The second line of HERMES.file contains the (HEX) numbers:
  47.           "2 3 8 F F F C A 0 E 0 0".  These are the 4 colors of DU-HERMES:
  48.           Dark blue: 238,  White FFF,  Gold: FA0,  Red: E00.
  49.           
  50.           I have included herein a program called PALETTE.  This is a small
  51.           modification of Carolyn Scheppner's Palette Tool program.
  52.           Run DU-HERMES, choose PALETTE in the file listing on the left
  53.           and then click into the RUN gadget.  The palette will fall on the
  54.           screen of DU-HERMES.  Change the colors as you please.
  55.           Each time you modify a color, pick up the 3 numbers representing
  56.           that color.
  57.           These are the 3 numbers on the right of the palette window.  For
  58.           example, if you see 3EF, the 3 numbers are 3, E, and F.
  59.           Put these 12 numbers on the second line of HERMES.file, and...
  60.           voila!  You've got your own colors!  Put the numbers in exactly
  61.           as you see them in the file right now.  This is the only use of the
  62.           PALETTE.  It is not needed for the program to run.
  63.  
  64.        C) CHANGE PATH FOR HERMES.file:
  65.  
  66.           This is also very easy to use.  I have included herein a small
  67.           program called DUH.Config.  You can use it to place the HERMES.file
  68.           wherever you want it permanently.  Assume the you would like the
  69.           HERMES.file to be in the directory DF0:c.  All you need to do is:
  70.  
  71.           Have your DUH.Config file where DU-HERMES is and press:
  72.           DUH.Config DF0:c/HERMES.file.  
  73.  
  74.           That's it!  Now, you must place your HERMES.file in the directory
  75.           DF0:c and DU-HERMES will know where to find it from now on! 
  76.           You can have a path of up to 30 characters long.
  77.  
  78.           This is the only use of DUH.Config.  You don't need it to run
  79.           DU-HERMES.  
  80.  
  81.           REMEMBER:  Since now DU-HERMES knows where the HERMES file is,
  82.           you can PLACE DU-HERMES in your c DIRECTORY and RUN IT FROM
  83.           ANYWHERE!  Yes, that's the idea.  You can run it from anywhere
  84.           on your Amiga by pressing: Run DU-HERMES, or simply DU-HERMES.
  85.  
  86.           Naturally, you can repeat any of the above items A)-C) whenever
  87.           you please.
  88.  
  89.        D) STORAGE:
  90.  
  91.           Choosing this menu item, you get the bytes available on your
  92.           current drives.  If a floppy has been removed, or a hard disk
  93.           drive cannot be read, you get "No disk present" in the corre-
  94.           sponding entry of the Storage Report.
  95.  
  96.           Storage will be shown for the drives DF0: - DF4:, DH0: - DH9:,
  97.           VD0: and VDK:.  If you have any other arrangement, I will plea-
  98.           santly send you a copy of DU-HERMES that takes care of it.
  99.  
  100.        E) WORKBENCH:
  101.  
  102.           This is a very useful menu item.  By choosing it, you reduce
  103.           the size of DU-HERMES to nothing!  It becomes a small window
  104.           so that you can work on the Workbench.  Activate that window,
  105.           then press <RETURN> and you are back in the directory you
  106.           were before.  If you have manually erased that directory from
  107.           the S (Source) gadget, DU-HERMES will show the contents of
  108.           your first drive.
  109.           
  110.           Various other improvements, including the inclusion of more
  111.           error statements, have been made.
  112.  
  113.        F) SAVE LIST:
  114.  
  115.           Choosing this item allows you to save the file listing on the
  116.           left exactly as it is, i.e., alphabetically and with the file
  117.           sizes.  CAUTION:  The list will be saved into a file whose name
  118.           is the one that you put in the C gadget.  If this file exists, 
  119.           it will be overwritten!  So, don't blame me...
  120.  
  121.        G) PATTERN MATCH:
  122.    
  123.           Just enter a string into the C gadget and then choose this menu
  124.           item.  DU-HERMES will find and highlight all the files in the
  125.           current directory that contain that string in their names.  This
  126.           process is case-insensitive, i.e., lower case or caps make no
  127.           difference.
  128.           To clear the highlighted filenames, just click into the CLEAR
  129.           gadget.
  130.  
  131.        H) FIND FILE:
  132.  
  133.           You can now locate any file in the current directory that has
  134.           the name that you enter in the C gadget.  Again, if that name in
  135.           the C gadget already exists, it will be overwritten...
  136.           The entire directory and all of its subdirectories are scanned.
  137.           I have avoided pattern matching in this piece of code to save time.
  138.           I use instead the Manx access() function.       
  139.  
  140.  
  141.           THIS IS A SHAREWARE PROGRAM. 
  142.  
  143.      IF YOU USE THE PROGRAM, PLEASE SEND $15.00 TO
  144.  
  145.                    A. G. Kartsatos
  146.                    8524 Caladesi Island Drive
  147.                    Tampa, FL 33637, USA
  148.  
  149.      Other programs by the author:
  150.  
  151.      PALETTA.ARC    (Color Mixing, Modifying IFF's, Random Colors)
  152.      CALCULA.ARC    (An Expression Parser And A Function Evaluator.  Unique!)
  153.      SIMPLICA.ARC   (The Simplex Method Of Linear Programming)
  154.      ROST.ARC       (Reports On Storage And Tasks On Their Windows. Useful!)
  155.      LISTA11.ARC    (Very Useful Directory Lister.  Alpha, Bytes, Patterns,
  156.                      CLI, Refresh.  Opens Its Own Window)
  157.      SCRIPTA.ARC    (Online!-PCP Script Maker.  Easy Script Files!)
  158.      FORMULA!.ARC   (Formidable 3D-Grapher In C. It graphs z = f(x,y).  Choice
  159.                      Of Colors.  17 Functions Supported.  An Artist's Tool)
  160.      FINANCA.ARC    (Mortgage, Compound Interest And Annuity)
  161.      CONTOURA.ARC   (Spectacular Contour Grapher.  Definitely An Artist's
  162.                      Tool.  CENTER, ZOOM IN, ZOOM OUT, FLOWING PALETTE...)
  163.      ARCHA11.ARC    (ARC-PAK-ZOO Utility.  It Also Has Another 12 Utility
  164.                     Gadgets And 7 Drive Gadgets.  Only 29K, It Can Be Used
  165.                     As An Efficient Directory Utility)
  166.  
  167.      Feel free to distribute this program, with this doc intact, to any
  168. bulletin boards and other non-profit establishments in the US and abroad.
  169.      You may also upload this program to major boards like Compuserve, 
  170. Delphi, GEnie, PLink, etc.
  171.      The inclusion of this program, or any part of it, in any form in a 
  172. commercial package, or its use for any commercial purposes, requires the 
  173. written permission of the author.
  174.  
  175.     FOR SUPPORT, CALL *HERMES BBS* IN TAMPA, FL.    
  176.     TELEPHONE: 813-985-7624.  70 MEG OF STORAGE, 1500 FILES ONLINE, GOOD
  177. MESSAGE BASE.
  178.     ALTHOUGH IT IS A PRIVATE BOARD, YOU MAY LEAVE A MESSAGE TO THE SYSOP
  179. CONCERNING ANY QUESTIONS OR COMMENTS YOU MIGHT HAVE ABOUT HERMES' PROGRAMS.
  180.  
  181.                      DU-HERMES  (Version 2.5)
  182.  
  183.      Here is a new and better version of DU-HERMES.  It now has another
  184. page of gadgets (72 total number of gadgets) that is user-configurable and
  185. allows the user to use PARAMETERS in his commands.
  186.      You can now run it from the Wbench with an icon too!
  187.      In the file HERMES.file, these are the 24 last entries.  Each entry
  188. has a gadget title as before (see below) under which the user can enter
  189. a command with up to 2 parameters.  For example, if you want your own
  190. gadget with the command FIXOBJ in it, just use the title FIXOBJ in the
  191. corresponding position of HERMES.file and under it add "Run Fixobj %s %s"
  192. without the quotes of course.  The symbols %s %s stand for the two para-
  193. meters that Fixobj needs.  The first one is the filename and the second
  194. is the new filename.  The first parameter is the name of the file that
  195. you have clicked in the table of files on the left, and the second is
  196. a filename that you must enter in the C gadget.  For example, to Fixobj
  197. the file "HELLO" with new name "GOODBYE", enter "GOODBYE" in the C gadget,
  198. click the filename "HELLO" in the table of files and then click the
  199. FIXOBJ gadget.  One-parameter commands will contain only one symbol "%s"
  200. and that can be a filename from the table of files or any name in the
  201. C gadget.
  202.      DU-HERMES now has the WBench screen as the background screen and only
  203. 4 colors.  This makes the program considerably faster than its previous
  204. versions.  
  205.      I have added 3 more gadgets per page and a "TASKS" entry in the menu
  206. to display the current tasks.  The gadgets are: COPYDIR, EXEC-CLI and
  207. NEWCLI (see below).
  208.  
  209.      EXPLANATION OF BUILT IN GADGETS:
  210.  
  211.      ALL:        Highlights all files, except directories.
  212.  
  213.      CLEAR:      Removes the highlighting from all files and directories.
  214.  
  215.      BYTES:      Displays at the bottom the number of bytes in all the
  216.                  highlighted files (not directories).
  217.   
  218.      EDIT:       Edits the file that you have highlighted by clicking into
  219.                  its line in the table of files on the left.  Make sure
  220.                  you are not trying to edit a directory.
  221.  
  222.      READ:       Reads ASCII file you have selected.  This process uses
  223.                  the console device.  It will not work on binary files.
  224.  
  225.      SHOW:       Shows the pictures you have selected.  You must have the
  226.                  program SHOW in your C directory.  Andry Rachmat's SHOW
  227.                  program is the best for me.
  228.  
  229.      DELDIR:     Deletes the selected directory.  You must delete all the
  230.                  files inside a directory before you use this function.
  231.                  This function works only on directories.
  232.  
  233.      PARENT:     Moves up one step in the directory tree.  It will stop
  234.                  moving when it hits a root directory.
  235.  
  236.      MAKEDIR:    Creates a new directory with the name that you have 
  237.                  entered in the C gadget.
  238.  
  239.      COPY:       Copies all the files that you have selected into the
  240.                  Destination Directory that you have entered in gadget D.
  241.                  Does not work on directories (see COPYDIR below).
  242.  
  243.      RENAME:     Renames a selected file or directory.  The new name
  244.                  should be entered in the C gadget on the left.
  245.  
  246.      SWAP:       Toggles between the Source (S) gadget and the Destination
  247.                  (D) gadget.
  248.  
  249.      DELETE:     Deletes the selected file.  It will not work on directories.
  250.  
  251.      GETDIR:     Attaches to the selected directory and displays its files.
  252.  
  253.      PRINT:      Prints the file you have selected to the printer.
  254.  
  255.      LISTARC:    Lists the files in an archived file you have selected.
  256.  
  257.      UNARC:      Unarcs the files of an archived file you have selected. Then
  258.                  it re-displays the contents of the current directory with
  259.                  the files extracted.  A re-direction window shows the
  260.                  result of the unarcing.
  261.  
  262.      ARC:        Arcs the files you have selected into an archived file
  263.                  that has the name you have entered in the C gadget.  You
  264.                  don't have to include the ending .ARC in the C gadget.
  265.  
  266.      SINFO:      Displays the number of bytes available in the current
  267.                  volume (like VD0:, DF0:, etc) in the Source gadget.
  268.  
  269.      DINFO:      Displays the number of bytes available in the current
  270.                  volume (like VD0:, DF0:, etc) in the Destination gadget.
  271.  
  272.      RUN:        Runs any file you have selected.  Make sure it is a
  273.                  runable file.
  274.                  CAUTION: The file you have just run,like FACC or QMouse,
  275.                  might be a resident program that does not close the
  276.                  DU-HERMES WINDOW until it is off.  Remember this remark!
  277.  
  278.      COPYDIR:    Copies a selected directory into the directory specified
  279.                  in the Destination gadget (D).
  280.  
  281.      EXEC-CLI:   It executes any CLI command that you enter in your C
  282.                  gadget.  For example, if you enter in the C gadget:
  283.                  "Run DH1:DELPAINT/Dpaint" and then you click into the EXEC-CLI
  284.                  gadget, you are running the program Dpaint residing in the
  285.                  directory DH1:DELPAINT.  Now, remember!  You cannot always
  286.                  do this.  If you say "Run DH1:SONIX/Sonix" and then you
  287.                  click EXEC-CLI, you are not going to be able to run Sonix.
  288.                  This is because the Sonix program looks for its files like
  289.                  Scores, etc.  If it doesn't find them, it does not load!
  290.                  In this case, you should use the MACROS gadgets as I have
  291.                  indicated in the HERMES.file.
  292.                  CAUTION: When you run the program by its icon, you should
  293.                  include the entire pathname for the files you might use in
  294.                  the command in the gadget C.
  295.  
  296.      NEWCLI:     Opens a new CLI window on top of the DU-HERMES screen.
  297.  
  298.      PAGE 1:     Activates the built in gadgets.
  299.  
  300.      PAGE 2:     Activates the MACROS gadgets.
  301.  
  302.      PAGE 3:     Activates the PARAMETERS gadgets. 
  303.  
  304.  
  305.                            DU-HERMES  (Version 2.0)
  306.  
  307.  
  308.      This is a major revision of the DU-HERMES program.
  309.  
  310.      NEW FUNCTIONS: (You need the STACK command in your "c" directory)
  311.  
  312.      MACRO-CONFIGURABLE GADGETS:  The second page in the program is entirely
  313. user-configurable.  Each gadget on that page can be configured so that
  314. when you click on it once it executes a sequence of up to 7 commands.  These
  315. commands reside in the file HERMES.file (see details below).
  316.  
  317.      A CONTINUOUSLY RUNNING CLOCK:  This clock is in the attached
  318. MODULE file which resides in your current "c" directory.  The clock commu-
  319. nicates with DU-HERMES via a port.  When DU-HERMES is clicked off, it
  320. sends a message to the port.  The clock receives it and closes itself
  321. down.
  322.  
  323.      RAM:  I have added another little window on top of the screen that
  324. gives you the RAM:.
  325.  
  326.      MEMORY:  This is another MENU entry that gives you separately the
  327. FAST MEMORY, the CHIP MEMORY and the AVAILABLE MEMORY.
  328.  
  329.      READ: I have written my own ASCII reading program that uses the
  330. custom window and the console device instead of stdout and WBench.  I
  331. think it is very nice.  I might even expand it to a full-featured editor.
  332.  
  333.      INFO: This command is in the MENU and gives you the INFO command, but
  334. without the rather disturbibg "Volumes Mounted" at its tail!
  335.  
  336.      I have deleted the copiers (DISKCOPY & FORMAT) because they are two
  337. slow when done on DirUtils.  
  338.  
  339.      1) Use from CLI or WorkBench.
  340.  
  341.      2) To prepare your own command sequences, remember the following:
  342.  
  343.      2a) HERMES.file starts always with an empty line and finishes with
  344. an empty line.  Each gadget name contains exaclty 10 characters.  This
  345. includes the quote (") at the end of the name of the gadget.  Center your
  346. custom gadget name as much as possible.  Your gadget name can of course have
  347. up to 9 characters that will appear on the second page of gadgets.  
  348.  
  349.      2b) Right after each custom gadget name you may put your own commands. 
  350. Eache line will contain ONLY ONE COMMAND.  Do not string them together! 
  351. You can afford up to 7 commands under each gadget name.  However, only the
  352. first command can contain the "cd" command in it.  I did it this way, so
  353. that the program does not have to look for "cd" all the time and slow
  354. down.  You can change ALL 21 gadgets of Page 2. At the
  355. end of the sequence of commands under a gadget you MUST HAVE AN EMPTY
  356. LINE.
  357.  
  358.